home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / cad / fs021b.zip / FS.TXT < prev    next >
Text File  |  1996-06-07  |  10KB  |  257 lines
  1.                        ForeSpace OS/2 ver 0.21b
  2.  
  3.  
  4.  
  5.  
  6. This version is still quite beta, though not to the same degree as the
  7. last. I have managed to make a few nice scenes with it.
  8.  
  9. This is identical to version 0.20b, with the addition of a toolbar and
  10. with the lines from objects behind the camera being clipped.
  11.  
  12.  
  13.  
  14. Basic Instructions:
  15. ------------------
  16.  
  17. Most menu commands are fairly self-explanatory:
  18.  
  19. File menu:
  20.  
  21.     Your standard open/save/export kind of stuff, and the settings
  22. dialog. Use this dialog to specify include directories and files for 
  23. the scene, and directory locations for file output, povray.exe and 
  24. your image viewer. 
  25.     When additional files are included, the textures/pigments/finishes
  26. from these files are read in immediately for use in the scene. If files
  27. are removed from this list however, the textures etc. from the files
  28. will remain in memory until the program is quit. So you will still be
  29. able to assign them to objects, but they will be found to be missing
  30. the next time you start the program.
  31.  
  32.  
  33. Edit menu:
  34.  
  35.     Selecting objects:
  36.         Quite a handy function is the ability to select and work on 
  37. multiple objects simultaneously. This presents a hierarchical list of 
  38. visible objects from which you can select as many as you like.
  39.  
  40.     Deleting and copying objects:
  41.         All currently selected objects will be deleted or copied. If 
  42. deleting CSG objects, you will be prompted to decide whether to delete
  43. the object's children. If you opt to delete the children, any further 
  44. descendents will be deleted too (ie: the children's children etc).
  45. When copying a CSG object, the children are automatically copied.
  46.  
  47.     Changing object's values:
  48.         Changes made in this dialog apply to all the selected objects.
  49. If the selected objects have differing values in any respect, the 
  50. value shown in the dialog box is a "*". If the values are the same for
  51. all the selected objects, the actual values will be shown.
  52.  
  53.         By default, the values represent the actual values of the
  54. object's transformations and changes to these will set the
  55. corresponding transformation value on all the objects. Alternatively, 
  56. by selecting the "values indicate change in variable" radio button, 
  57. the fields will all be reset to 0.0 and the values you enter will be
  58. added to the object's current values. This is useful if you have 
  59. selected a range of object's with differing tranformations, and wish 
  60. to move them all a certain amount in a certain direction, while not 
  61. changing their locations with respect to each other (or similar with 
  62. their scaling or rotation values).
  63.  
  64.         Likewise, the texture and layer fields will apply to all
  65. selected objects.
  66.  
  67.     Extended edit:
  68.         This only applies to CSG, torus, height_field and spotlight
  69. objects currently. If multiple objects are selected, the extended edit
  70. dialog will come up once for each object, changes in the dialog will
  71. not apply to all selected objects.
  72.  
  73.     Camera location and look at:
  74.         Pretty obvious. When you select these you can use the object
  75. settings dialog to set the location, or just drag it around the 
  76. screen.
  77.  
  78.     Visible layers:
  79.         Allows you to select which of the 32 layers are currently 
  80. visible. If you are making a scene with lots of objects this is very 
  81. useful for speeding up the redrawing while you are working on it.
  82.  
  83.  
  84. Primitives menu:
  85.  
  86.     Selecting from this menu will create the selected primitive with
  87. default values.
  88.  
  89.     The only one worth mentioning is the CSG, which presents you with 
  90. a dialog to specify the CSG's particulars. The list of objects is 
  91. initially all the currently selected objects, and the operation is 
  92. union. The selected object in the list is the primary object for the 
  93. operation.
  94.  
  95.     If you click "Edit list", you will get a dialog containing a
  96. list of all eligable objects (ie: those that don't already belong to 
  97. another CSG). You can select as many of these as you wish to be in the
  98. CSG.
  99.  
  100.  
  101. Texture editor:
  102.  
  103. Note: you really need to be operating in 16bit or better colour depth 
  104. for the colours to be displayed accurately.
  105.  
  106.     Currently, the texture editor does not allow any operation on
  107. included textures, you may only edit your own textures.
  108.  
  109.     When you create a texture, you are able to assign pre-defined or 
  110. included pigments, normals and finishes. The values in these
  111. pre-defined elements are then overridden by the values you specify. 
  112. Only values you change will be used to override the pre-defined 
  113. element's values. eg: Glass_Finish has its ior set to 1.5 or so, if 
  114. you select Glass_Finish, you will note that the refraction value stays
  115. at 1.00. This will not override the value in Glass_Finish unless you 
  116. change it from this default.
  117.  
  118.     You do not have to specify any pre-defined elements if you do not
  119. wish to, the texture will be composed solely of the actual values you
  120. give.
  121.  
  122.     When creating a pigment, you should select the type first, then
  123. edit the colours. The way the colours are displayed depends on the
  124. pigment type. When editing the colours, you are restricted to the
  125. appropriate number of colours (ie solid = 1; checker = 2; hexagon = 
  126. 3; gradient = 2 -> 20). The positions of the colours can be changed by
  127. clicking on the colour bar while editing. This also changes the value
  128. for colour gradients. Play around with this and you will see what I
  129. mean.
  130.  
  131. As with the textures, the included texture elements are not editable
  132. in themselves. (This is because I have not gotten around to writing a
  133. good parser for the povray files).
  134.  
  135.     There is not currently any facility to generate texture maps or 
  136. layered textures.
  137.  
  138.  
  139. Tools menu:
  140.  
  141.     The align and spread functions are not operable, though most 
  142. alignment needs can be met through the use of multiple selection and 
  143. changing selected object values.
  144.  
  145.     The object count function just counts the number of objects of 
  146. each type. Really only for my use.
  147.  
  148.     Describe object motion and generate frames are not yet operable.
  149. These will, of course, facilitate animation once I have implemented 
  150. them.
  151.  
  152.     Trace frame:
  153.         Allows you to trace the image. Pretty straight-forward, just 
  154. kicks POV-Ray off in a separate session with the settings you specify 
  155. in the dialog box. 
  156.  
  157.     When this option is selected, the scene is exported to a POV file
  158. first. The pov file name will be the name you specified when you last
  159. exported it, or if you have not exported it it will be generated from
  160. the name of the 4SP file you're working on. If that doesn't have a
  161. name either, you will be prompted for a pov file name.
  162.  
  163.     Currently, there is no communication between the POV-Ray session
  164. and ForeSpace, so it doesn't know when the trace have finished. You'll
  165. have to keep an eye on the current task list (or just wait for the 
  166. system performance to pick up again) to know when it has finished.
  167.  
  168.     Incidentally, I find that setting PRIORITY=ABSOLUTE in the 
  169. config.sys prevents POV-Ray from sucking too much processor time from 
  170. your other apps, thus providing a more responsive system while you are
  171. tracing in the background. Of course the trace proceeds more slowly, 
  172. but not by much.
  173.  
  174.     Image viewer:
  175.         Just kicks off the image viewer you have specified in the 
  176. file/settings dialog, passing the name of the POV-Ray output file. 
  177. This does not check to see if the trace has finished first.
  178.  
  179.  
  180.  
  181. General:
  182. -------
  183.     Mouse operations:
  184.  
  185.         Left-button dragging translates all currently selected 
  186.         objects.
  187.  
  188.         Right-button dragging moves the viewplane. (Excluding the 
  189.         camera view, whose viewplane is set by the camera
  190.         location/look_at)
  191.  
  192.         Right & left-button dragging zooms the view in/out with
  193.         left/right movement.
  194.  
  195.  
  196.     Multiple object operations caution:
  197.  
  198.         When operating on CSGs be careful you don't have the CSG's
  199.         children selected as well, otherwise any operations you do 
  200.         will be applied to the parent and to the children. ie: The
  201.         parent will move, and the children will move _inside_ the
  202.         parent, so the child has moved twice as far.
  203.  
  204.         Also, get into the habit of using the "Deselect all" button. 
  205.         It is easy to acidentally leave some objects selected while 
  206.         you work on others.
  207.  
  208.  
  209. Known Bugs:
  210.  
  211. Every now and then, one of the views seems to turn inside out and 
  212. become inverted. I have zero (0.00E-99) idea why this occurs. Clicking
  213. the mouse on the view to make a redraw occur will fix it up.
  214.  
  215. Still not clipping the lines behind the camera, so when there is an 
  216. object behind the camera, it causes lines everywhere on the camera 
  217. view. I will fix this I promise.
  218.  
  219. A texture that has no values of any kind will still be exported, and
  220. POV-Ray will complain about it. Just stick some pigment type in it and
  221. it's fine.
  222.  
  223. That's it! (yeah right)
  224.  
  225.  
  226.  
  227.  
  228. ForeSpace OS/2 was written in Borland C++ 2.0 using ObjectWindows.
  229. Mainly for the purpose of allowing an easy port to Windows NT, but as 
  230. it turns out, ObjectWindows is not all it's cracked up to be.
  231. I'm considering converting to VisualAge C++. Any recommendations 
  232. anyone?
  233.  
  234.  
  235. Still a long way to go with this I know. Just thought I'd release a 
  236. version that was less shonky than the last.
  237.  
  238. Coming features:
  239.  
  240.  - Function to import objects and textures from other 4SP scene files.
  241.  - Material maps / layered textures
  242.  - Some more bugs
  243.  - General shape generation
  244.  - Animation (last)
  245.  - Statistics / maths pop quiz function to make up for all the time
  246.    Sean spent doing this instead of being at Uni. :)
  247.  - Anything (almost) that anyone suggests I put in
  248.  
  249.  
  250. Please tell me about any bugs you find.
  251.  
  252. Sean
  253.  
  254. damien@mpx.com.au
  255. s3042813@titanic.mpce.mq.edu.au
  256.  
  257.